home *** CD-ROM | disk | FTP | other *** search
/ Ian & Stuart's Australian Mac 1 / Ian and Stuart's One (Australia).iso / Australasian Legends / Commercial / Rainbow Hill / MacDOS™ 2.0.0 / User's Guide / 01 Welcome to MacDOS < prev    next >
Text File  |  1994-09-20  |  13KB  |  257 lines

  1. 1  Welcome to MacDOS
  2.  
  3. Why MacDOS ?
  4.        MacDOS  satisfies  the need of many Macintosh  users  to  be
  5.        able  to  avoid  repeating  particular  sequences  of  mouse
  6.        operations when working with files.
  7.  
  8.        Normally,  you  handle  documents on the  Macintosh  desktop
  9.        through  the  Finder.  It  is the Finder  that  creates  the
  10.        desktop  metaphor  by drawing icons and  responding  to  the
  11.        mouse. Together, the Macintosh Operating System (MacOS)  and
  12.        the  Finder have made computers accessible to all those  who
  13.        were intimidated by technical jargon and arcane commands.
  14.  
  15.        Nevertheless,  the ease of use of a Graphic  User  Interface
  16.        (GUI)  does  not  come  free  of  charge:  operations  which
  17.        require  brief  commands on another computer need  sometimes
  18.        an  almost interminable repetition of clicking and  dragging
  19.        on the Mac.
  20.  
  21.        People who have never used any other computer before do  not
  22.        realise  it, but others, who have worked with DOS  or  UNIX,
  23.        immediately  see  that limitation. This is partly  why  many
  24.        computer  professionals have seen the Macintosh  more  as  a
  25.        toy rather than as a system capable of doing serious work.
  26.  
  27.        For  the  past  few  years, hundreds of software  developers
  28.        have worked hard at providing a Macintosh-like interface  on
  29.        every  conceivable  computer. The  developers  of  Macintosh
  30.        software,  on  the other hand, have found  it  difficult  to
  31.        respond  to those potential users who would like to  have  a
  32.        character-based  interface to  the  MacOS  beside   the  GUI
  33.        provided by the Finder.
  34.  
  35.        MacDOS goes against the current tide and satisfies the  need
  36.        of  Macintosh power-users by providing a DOS-like  interface
  37.        on the Mac.
  38.  
  39. Introduction to MacDOS for DOS Users
  40.        Although  MacDOS provides a DOS-like user interface,  it  is
  41.        not  DOS. Therefore, you will find that some of the commands
  42.        do  not  behave  exactly like in DOS. Nevertheless,  80%  or
  43.        more  of  what most people do with MS DOS® 5.0 is  available
  44.        in MacDOS.
  45.  
  46.        Most  importantly, MacDOS is safer than DOS.  That  is,  you
  47.        will  never  type a harmless DOS-command and find  out  that
  48.        MacDOS responds to it by destroying your data!
  49.  
  50.        Most  commands accept full paths as arguments. Their  format
  51.        is  like  in DOS, but in MacDOS we have replaced the concept
  52.        of   file   extension  with  the  more  powerful   mechanism
  53.        available  on the Mac of creators and file-types. With  most
  54.        commands,  you  will be able to complement or  replace  file
  55.        wildcarding  like  *.txt and *.exe with type  switches  like
  56.        /T=TEXT and /T=APPL .
  57.  
  58.        The  length  of  filenames  and directories  can  of  course
  59.        exceed  the  limit of eight characters imposed by  DOS.  You
  60.        can   also   include   spaces  and  other   non-alphanumeric
  61.        characters in names, provided you enclose the names  between
  62.        double  quotes (with the system variable QUOTE you can  also
  63.        change the character used for quoting).
  64.  
  65.        Another  change that we made in order to take  advantage  of
  66.        specific  Macintosh  features was the replacement  of  drive
  67.        IDs  with volume IDs. To avoid confusion, we have identified
  68.        volumes   with   numbers  rather  than  letters,   but   the
  69.        difference is more than cosmetic: the MacOS assigns  IDs  to
  70.        volumes  in  the order in which they are mounted  and  frees
  71.        the  IDs  when  the corresponding volumes are dismounted.  A
  72.        volume  ID identifies a particular floppy, rather  than  the
  73.        floppy  drive.  Therefore, your startup  disk  partition  or
  74.        floppy  is  always 1 and the volume ID assigned to  a  newly
  75.        inserted  floppy depends on what volumes you have  currently
  76.        mounted on your desktop.
  77.  
  78.        This  might  sound  a bit confusing, but you  will  find  it
  79.        natural as you get used to the Mac environment. To help  you
  80.        when importing batch programs from DOS, MacDOS provides  the
  81.        command  SUBSTVOL  which assigns a letter  to  a  particular
  82.        volume.  This  allows you to assign the appropriate  letters
  83.        to  the  necessary  volume IDs before  executing  DOS  batch
  84.        files within MacDOS.
  85.  
  86.        Similarly  to  what  happens  when  you  boot  DOS,   MacDOS
  87.        executes  the  file autoexec.bat found in the  folder  where
  88.        the  application  resides (not where you  place  aliases  of
  89.        MacDOS).   There  is  no  MacDOS-equivalent  of  config.sys,
  90.        though.
  91.  
  92.        The    Command    Reference   Section   provides    detailed
  93.        descriptions of the differences between MacDOS commands  and
  94.        their DOS counterparts.
  95.  
  96. Introduction to MacDOS for Mac Users
  97.        This  section  is only going to explain very basic  concepts
  98.        of  MacDOS' character based interface. Also refer to the DOS
  99.        Glossary Section for an explanation of the terminology  used
  100.        in this manual.
  101.  
  102.        To  understand  MacDOS you have first of all to  think  that
  103.        the  operations  possible  with files  and  folders  do  not
  104.        depend  on the way in which you direct the Operating  System
  105.        to  perform  them.  Moreover, the  differences  between  the
  106.        Macway  and  the MacDOSway are pretty consistent across  the
  107.        operations. Therefore, once you will have discovered how  to
  108.        perform,   say,  a  file  copy,  you  will   be   close   to
  109.        understanding  how to perform file renaming,  file  listing,
  110.        etc.
  111.  
  112.        When MacDOS starts, it opens a window, displays a prompt  to
  113.        tell  you  that  it is ready, and waits for you  to  type  a
  114.        command.
  115.  
  116.        There  are  many commands that you can type,  but  they  all
  117.        consist  of  a verb (the command name) possibly followed  by
  118.        some  other words (the command parameters). The command name
  119.        tells  MacDOS  what  to do and the command  parameters  tell
  120.        MacDOS on what it should operate.
  121.  
  122.        To  type  a  command you just enter its name and  parameters
  123.        from  the  keyboard. You then press the return key  to  tell
  124.        MacDOS  that  the command is complete and can  be  executed.
  125.        MacDOS  executes the command and then displays a new  prompt
  126.        to tell you that it is ready to accept more commands.
  127.  
  128.        For  example,  TYPE  filename  lists  the  text  file  named
  129.        filename  on the screen. Similarly, DEL oldfile removes  the
  130.        file  named oldfile from your system, as if you had  trashed
  131.        it  and  then  directed  the  Finder  to  empty  the  Trash.
  132.        RENAME  oldname  newname changes the name  of  a  file  from
  133.        oldname to newname, while COPY oldname newname makes a  copy
  134.        of the file named oldname and names it newname.
  135.  
  136.        You  can  modify the operation of a command by  typing  some
  137.        special  arguments called options or switches. For  example,
  138.        you  might like that a COPY command verifies that  the  copy
  139.        of  the  file is identical to the original. To achieve  that
  140.        result, type /V before hitting the return key.
  141.  
  142.        The  Finder  mostly operates on files or folders  which  are
  143.        displayed in the front window. A similar concept applies  to
  144.        MacDOS,   where  most  commands  operate  on   the   default
  145.        directory (the term directory is a synonym of folder).  When
  146.        MacDOS  is  launched, the default directory  is  the  folder
  147.        which  contains  the  icon of MacDOS  itself,  but  you  can
  148.        change it with the command CHDIR.
  149.  
  150.        You  can also list the contents of a folder with the command
  151.        DIR,  and there are also commands to create, copy, and trash
  152.        folders.
  153.  
  154.        If  you  want  to  operate on a file which  is  NOT  in  the
  155.        default  directory, you can specify the file  by  prepending
  156.        to  its  name a string which identifies where the  file  is.
  157.        Such  a  string is called path and consists of the  name  of
  158.        all  the  folders that you would have to open to  reach  the
  159.        file.  Each  folder  name is followed by  a  backslash.  For
  160.        example,  let's suppose that the default directory  contains
  161.        a  folder called myFolder which in turn contains a text file
  162.        called  myFile. If you want to print myFile, you can  either
  163.        change  the  default directory to myFolder with the  command
  164.        CHDIR  myFolder  and then print the file  with  the  command
  165.        PRINT  myFile  or  do  the  printing  without  changing  the
  166.        default      directory     by     typing     the     command
  167.        PRINT myFolder\myFile .
  168.  
  169.        One  of the big advantages of MacDOS over the Finder is that
  170.        you   can   use   wildcards   to  identify   several   files
  171.        simultaneously. For example, DEL p* deletes all files  whose
  172.        name  begins with the letter p (or P, as the Mac OS  is  not
  173.        case  sensitive).  Also, DEL x??? deletes  all  files  whose
  174.        name begins with x and is exactly four characters long.
  175.  
  176.        To  interrupt the execution of a command, you can  type  the
  177.        standard command-dot key combination.
  178.  
  179.        If  there  are  particular sequences of commands  which  you
  180.        need  to use over and over again, you can write the commands
  181.        in  a  text file and then type the name of the file  at  the
  182.        MacDOS  prompt. In this way you can effectively  extend  the
  183.        standard   commands  available  in  MacDOS  with  your   own
  184.        procedures. Such files are called batch programs.
  185.  
  186. What do You Need and What is in the Package ?
  187.        MacDOS  uses  500kByte of RAM and requires System  6.0.8  or
  188.        greater.  Moreover, it requires System 7.0  to  be  able  to
  189.        launch other Macintosh applications.
  190.  
  191.        MacDOS  itself fits into 240kb of disk space, but you should
  192.        reserve  additional  space  if  you  want  to  keep  on-line
  193.        batches,  filter extensions, README files, and  this  User's
  194.        Guide.
  195.  
  196.        The  MacDOS  package consists of this manual and a  800kByte
  197.        3.5"  floppy  disk.  The floppy contains  a  self-extracting
  198.        archive  with  the  MacDOS application,  examples  of  batch
  199.        files,  examples  of filter extensions, a shell  project  to
  200.        build  your  own extensions, this User's Guide, and  various
  201.        README files.
  202.  
  203. How to use this Manual
  204.        This  manual should provide all the information you need  to
  205.        understand MacDOS and to use it efficiently.
  206.  
  207.        Beside  the  section of general introduction  that  you  are
  208.        reading right now, you will find:
  209.  
  210.        Section 2:  The Environment
  211.          How you interact with MacDOS.
  212.          If   you   have   no  experience  with  DOS,  you   should
  213.           definitely read this section. It will also introduce  you
  214.           to some terminology commonly used in DOS.
  215.          If  you  know  DOS, you can skip most of the  section  but
  216.           have  a  look  at the parts where the error mechanism  is
  217.           introduced and the MacDOS window explained.
  218.  
  219.        Section 3:  Data on the Mac
  220.          How  the  Macintosh  organises data and  what  information
  221.           visible on the desktop is accessible via MacDOS.
  222.          If  you  have ever looked into Inside Macintosh,  you  can
  223.           probably skip this section.
  224.  
  225.        Sections 4 to 12:  MacDOS Functionality
  226.          What  MacDOS  can do, organised on the basis of functional
  227.           areas.
  228.          The  functionality of all MacDOS commands is explained  in
  229.           a  coherent way and without letting the details cloud the
  230.           big  picture. You should definitely browse through  these
  231.           sections if you have no experience in DOS.
  232.          If  you have DOS experience, you should still look at  the
  233.           commands which are not available in DOS and find out  how
  234.           they fit into the general strategy.
  235.  
  236.        Section 13:  Command Reference
  237.          One chapter on each command, with all options explained.
  238.          Several   examples  are  provided,  as  well  as  possible
  239.           causes  of commonly occurring errors. For commands  which
  240.           exist   in   DOS,   the  differences  between   the   two
  241.           implementations are listed.
  242.          You  should  refer to this section before using a  command
  243.           with which you are not familiar.
  244.  
  245.        Appendix A:  Error Codes
  246.          Each   possible   error  code  returned   by   MacDOS   is
  247.           explained, with some indications of the possible causes.
  248.  
  249.        Appendix B:  Extension Programming
  250.          How   to  write  filter  applications  that  accept  piped
  251.           MacDOS commands.
  252.  
  253.        Appendix C:  DOS Glossary
  254.          DOS   concepts   are  explained  in  terms  of   Macintosh
  255.           concepts.
  256.  
  257.